home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1120.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  3.2 KB  |  129 lines

  1. 25
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. ReadRegBinary 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baReadRegBinary gets a binary value from the Windows Registry.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = ReadRegString( KeyName, ValueName, Default, Branch )
  28. --- RECORDSEPARATOR ---
  29.  
  30. --- RECORDSEPARATOR ---
  31. Arguments:
  32. --- RECORDSEPARATOR ---
  33.  
  34. --- RECORDSEPARATOR ---
  35. String, String, String, String. 
  36. --- RECORDSEPARATOR ---
  37. KeyName is the name of the key. 
  38. --- RECORDSEPARATOR ---
  39. ValueName is the name of the value. Under 16 bit, this value is ignored. 
  40. --- RECORDSEPARATOR ---
  41. Default is the string that is returned if the key/value doesn't exist. 
  42. --- RECORDSEPARATOR ---
  43. Branch is the branch of the registry to use. Can be one of the following: 
  44. --- RECORDSEPARATOR ---
  45. "HKEY_CLASSES_ROOT" 
  46. --- RECORDSEPARATOR ---
  47. "HKEY_CURRENT_USER" 
  48. --- RECORDSEPARATOR ---
  49. "HKEY_LOCAL_MACHINE" 
  50. --- RECORDSEPARATOR ---
  51. "HKEY_USERS" 
  52. --- RECORDSEPARATOR ---
  53. ΓÇ£HKEY_CURRENT_USERΓÇ¥ 
  54. --- RECORDSEPARATOR ---
  55. ΓÇ£HKEY_DYN_DATAΓÇ¥ 
  56. --- RECORDSEPARATOR ---
  57. Under 16 bit, only the HKEY_CLASSES_ROOT branch is accessible - the Branch 
  58. --- RECORDSEPARATOR ---
  59. setting is ignored.
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. Returns:
  64. --- RECORDSEPARATOR ---
  65.  
  66. --- RECORDSEPARATOR ---
  67. List (Xtra) or string (UCD). 
  68. --- RECORDSEPARATOR ---
  69. Returns a list containing the binary value stored in Keyname. If the Keyname 
  70. --- RECORDSEPARATOR ---
  71. doesn't exist, then the return will be a list containing just the Default value.
  72. --- RECORDSEPARATOR ---
  73.  
  74. --- RECORDSEPARATOR ---
  75. Examples:
  76. --- RECORDSEPARATOR ---
  77.  
  78. --- RECORDSEPARATOR ---
  79. Director: 
  80. --- RECORDSEPARATOR ---
  81. set data = baReadRegBinary( "Courses\Computers", "Data", "Error", 
  82. --- RECORDSEPARATOR ---
  83. "HKEY_CLASSES_ROOT" ) 
  84. --- RECORDSEPARATOR ---
  85. Authorware: 
  86. --- RECORDSEPARATOR ---
  87. data := baReadRegString( "Courses\\Computers", "Data", "Error", 
  88. --- RECORDSEPARATOR ---
  89. "HKEY_CLASSES_ROOT" )
  90. --- RECORDSEPARATOR ---
  91.  
  92. --- RECORDSEPARATOR ---
  93. Notes
  94. --- RECORDSEPARATOR ---
  95. --- RECORDSEPARATOR ---
  96. In the Xtra, the return will be a list containing the binary values. eg: 
  97. --- RECORDSEPARATOR ---
  98. [ 23, 45, 68, 0, 3, 5, 0 ] 
  99. --- RECORDSEPARATOR ---
  100. In the UCD, the return will be a string with each value on a separate line. eg: 
  101. --- RECORDSEPARATOR ---
  102. "23\r45\r68\r0\r3\r5\r0" 
  103. --- RECORDSEPARATOR ---
  104. Use the Authorware GetLine function to retrieve the values. 
  105. --- RECORDSEPARATOR ---
  106. Note that these values will not be the same values as shown in RegEdit - the 
  107. --- RECORDSEPARATOR ---
  108. values in RegEdit are in hex, while the Xtra returns the decimal equivalents. If the 
  109. --- RECORDSEPARATOR ---
  110. key does not exist, then a list with the default value (as a string) as its only entry 
  111. --- RECORDSEPARATOR ---
  112. will be returned, eg: 
  113. --- RECORDSEPARATOR ---
  114. ["error"]
  115. --- RECORDSEPARATOR ---
  116.  
  117. --- RECORDSEPARATOR ---
  118. See also:
  119. --- RECORDSEPARATOR ---
  120.  
  121. --- RECORDSEPARATOR ---
  122. baWriteRegString 
  123. --- RECORDSEPARATOR ---
  124. baReadRegNumber 
  125. --- RECORDSEPARATOR ---
  126. baWriteRegNumber 
  127. --- RECORDSEPARATOR ---
  128. baDeleteReg